home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor1 / phone.doc < prev    next >
Text File  |  1995-03-31  |  5KB  |  97 lines
  1. (Comp.sys.handhelds) 
  2. Item: 1793 by ervin at pinbot.enet.dec.com 
  3. Author: [Joseph Ervin] 
  4.   Subj: Re: HP48SX Phone Number Manager V1.4 
  5.   Date: Thu Jan 24 1991 10:55 
  6.  
  7.    This program is a basic database program designed to keep a list of  
  8.    phone numbers and addresses, and provide access to them, editing, etc.. 
  9.  
  10.    To run it just download the following code and evaluate the program 
  11.    object. 
  12.  
  13.    The first time you run it, you'll be informed that no database exists 
  14.    and that you should create it. 
  15.  
  16.    When creating the database, which happens automatically the first time 
  17.    you run the program, you'll be prompted alternately for a name, phone 
  18.    number, and address.  If you don't want to enter a phone number or an 
  19.    address, just hit ENTER at these prompts.  Just keep entering the data 
  20.    at the prompts, and when you're through just hit ENTER at the name prompt 
  21.    without entering any data.  This will terminate the input mode. 
  22.  
  23.    Note: This method of input termination works any time you are prompted 
  24.    for a name and decide not to enter one.  Remember this as it will come 
  25.    in handy at other times when the program prompts you for a name. 
  26.  
  27.    Once you have created a database, running the program will prompt you as 
  28.    to whether you want to search the list or edit the list. 
  29.  
  30. 1. SEARCHING THE LIST.  
  31.  
  32.    The way to search the list is by pressing SRCH when prompted. The 
  33.    program will search each name in the list for any occurance of the 
  34.    string you enter (when prompted).  This way, you can search for people 
  35.    by last name, or whatever.  For example, if you have the phone numbers 
  36.    of all the local movie theaters, then entering CINEMA at the prompt 
  37.    will give you a list of all the movie theaters (assuming you were smart 
  38.    enough to use the string "CINEMA" as part of the name for each movie 
  39.    theater).  You get the idea.  The program will display a list of entries 
  40.    that matched the search string input by the user.  The default display 
  41.    mode shows the name/phone number, with a menu item (ADDR) by which 
  42.    the user can choose to display addresses.  Note that the same menu 
  43.    button toggles between ADDR mode (displaying addresses) and NUM 
  44.    mode (displaying phone numbers). 
  45.  
  46.    If you enter an asterisk ("*") at the prompt when searching the 
  47.    list, the program will output the entire list.  This is useful for 
  48.    going through the list (in edit mode, say) and deleting entries 
  49.    that are no longer needed. 
  50.  
  51. 2. EDITING THE LIST.   
  52.  
  53.    Basically, just follow the prompts and you'll do well. I tried to make 
  54.    this fairly straightforward, and I have put in some degree of error 
  55.    checking of input data to make sure it makes sense, but I'm sure you can 
  56.    get it to crash if you try.   Some simple rules to follow:  Avoid typing  
  57.    over the ":Name:", ":Number:", or ":ADDR:"  strings when entering data 
  58.    at a prompt.  The program uses these strings internally to find your 
  59.    input, so if you type over them, the program will get confused trying 
  60.    to isolate the actual input from within the input string. 
  61.  
  62.    The program uses the SRCH algorithm described above to locate the exact 
  63.    item you wish to edit.  When you have the exact item you wish to edit on 
  64.    the screen, press PICK and you will have a chance to make your changes. 
  65.    Again, the entire list can be viewed by specifying an asterisk as the 
  66.    search string. 
  67.  
  68.    Note:  When you press PICK, you will be prompted to edit either the 
  69.    name/number or name/address, depending on whether the number or address 
  70.    was being displayed when you pressed PICK.  This goes for deleting 
  71.    entries as well. 
  72.  
  73.    Any time you see an EXIT option on the menu bar, you can press it to 
  74.    back out of the program.  Sometimes it backs you out one menu level, 
  75.    and sometimes you exit the program entirely.  I tried to handle each 
  76.    case in the most natural way, rather than always doing the same thing.  
  77.    I hope you agree that this was the way to go. 
  78.  
  79.    Some usage notes:  I intentionally had the output of the SEARCH 
  80.    algorithm appear above the bottom of the display so there would be room 
  81.    for multiple lines of text in the :NUMBER: field.  This facilitates 
  82.    including home and work phone numbers for people in this field on two 
  83.    lines.  Just insert a line feed when entering/editing the entries.  The 
  84.    same goes for the ":ADDR:" field; use line feeds to separate lines of 
  85.    text in the address. 
  86.  
  87.    Anyway, here's version 1.4 of the program.  I hope you like it.  The 
  88.    comments will automatically strip out when you download to your 
  89.    calculator. 
  90.  
  91.    Enjoy, and please give me your comments, and any ideas you have for 
  92.    new features. 
  93.  
  94.    Regards, 
  95.  
  96.    >>>Joe Ervin 
  97.